Python console/pl

Other languages:

Wprowadzenie

Konsola Python jest panelem, który jest częścią interfejs użytkownika FreeCAD. Może być używany do sterowania procesami FreeCAD oraz tworzenia i modyfikowania obiektów i ich właściwości.

Można go uwidocznić/ukryć poprzez menu Widok → Panele → Konsola Python.

Konsola Pythona w FreeCAD obsługuje podstawowe kolorowanie składni, potrafi rozróżnić różne style i kolory, komentarze, łańcuchy, wartości liczbowe, wbudowane funkcje, wydrukowany tekst wyjściowy i separatory, takie jak nawiasy i przecinki. Te właściwości konsoli można skonfigurować w Edytor preferencji.

Konsola Pythona pokazująca komunikaty, gdy FreeCAD właśnie się uruchamia.

Tworzenie skryptów

Dla absolutnie początkujących, zobacz: Wprowadzenie do Pythona, oraz Samouczek tworzenia skryptów Python.

Zobacz również: Podstawy tworzenia skryptów FreeCAD, oraz Obiekty skryptowe.

Konsola Pythona potrafi wykonać uzupełnienie podstawowego kodu. Gdy po obiekcie zostanie zapisana kropka, pokaże na przykład publiczne metody i atrybuty (zmienne) bieżącego obiektu (klasy), obj.

Konsola jest również w stanie wyświetlić łańcuch dokumentacji konkretnej funkcji, gdy zapisywany jest otwierający nawias, na przykład function(

Przykładowy kod Pythona, który generuje obiekty w oknie widoku 3D.

Skrypty inicjujące FreeCAD automatycznie ładują niektóre moduły i definiują niektóre aliasy. Dlatego też, są one dostępne w konsoli Pythona

App = FreeCAD
Gui = FreeCADGui

W związku z tym są one równe

App.newDocument()
FreeCAD.newDocument()

Note: Te wstępnie załadowane moduły i aliasy są dostępne tylko z konsoli Pythona wbudowanej w program FreeCAD. Jeśli używasz FreeCAD jako biblioteki w zewnętrznym programie, musisz pamiętać o załadowaniu modułów FreeCAD i FreeCADGui i zdefiniowaniu niezbędnych aliasów, jeżeli zachodzi taka potrzeba.

Działania

Kliknij prawym przyciskiem myszy na konsoli Pythona, aby wyświetlić kilka poleceń:

Copy: Przechowuje zaznaczony tekst w schowku do późniejszego wklejenia. Funkcja jest wyłączona, jeśli nic nie jest zaznaczone.
Copy command: Przechowuje wybrane polecenie w schowku do późniejszego wklejenia. Funkcja jest wyłączona, jeśli nic nie jest zaznaczone.

Historia kopiowania: Skopiuj całą historię poleceń Pythona wprowadzonych w tej sesji.
Zapisz historię jako: Zapisuje całą historię poleceń Pythona wprowadzonych w tej sesji do pliku tekstowego.
Wklej: Wklej uprzednio skopiowany tekst ze schowka do konsoli Pythona.
Zaznacz wszystko: Zaznacza cały tekst w konsoli Pythona.
Wyczyść konsolę: Usuwa wszystkie polecenia wprowadzone do konsoli Pythona. Jest to przydatne, gdy konsola Pythona jest pełna komunikatów i wcześniej wprowadzonych poleceń, które mogą rozpraszać podczas testowania nowej funkcji. Jest to tylko estetyczne, ponieważ polecenie to nie usuwa istniejących zmiennych ani nie usuwa zaimportowanych modułów w sesji.
Wstaw nazwę pliku: Otwiera okno dialogowe do wyszukiwania pliku w systemie, a następnie wstawia pełną ścieżkę do pliku. Jest to przydatne do testowania funkcji, które przetwarzają plik wejściowy, bez konieczności zapisywania całej nazwy w konsoli, co jest podatne na błędy. To polecenie nie uruchamia pliku i nie importuje go jako modułu Pythona, tylko zwraca pełną ścieżkę do tego pliku.
Zawijanie linii: zawijaj bardzo długie linie, które przekraczają poziomy wymiar konsoli Pythona.

Uwagi

Istnieje możliwość przewijania API w konsoli Pythona. Przykład:
1. W konsoli wpisz: FreeCAD.
2. Pojawi się okno dialogowe z opcjonalnymi klasami / funkcjami do wyboru,
3. Przewiń listę, aby przeczytać opis każdej klasy / funkcji
4. Wybierając funkcję i podążając za nią z . można powtórzyć kroki 2 i 3, aby zagłębić się w API.
Uzupełnianie tabulatorami / słowami jest obsługiwane za pomocą skrótu Ctrl + Spacja

Interfejs użytkownika

Edytor ustawień, Dostosowywanie interfejsu użytkownika do własnych potrzeb
Okno główne: Menu główne, widok 3D, Widok połączony (Widok drzewa, Panel zadań, Edytor właściwości), Widok zaznaczenia, Widok raportu, Konsola Phyton, Pasek statusu, Widok DAG
Okna pomocnicze: Inspektor sceny, Graf zależności

Std: Narzędzia standardowe

Plik: Nowy, Otwórz, Zamknij, Zamknij wszystkie, Zapisz, Zapisz jako, Zapisz jako kopię, Zapisz wszystkie, Przywróć, Importuj, Eksportuj, Scal projekt, Informacje o projekcie, Drukuj, Podgląd wydruku, Eksportuj do PDF, Oststnio otwierane pliki, Zakończ

Edycja: Cofnij, Ponów, Wytnij, Kopiuj, Wklej, Powiel zaznaczenie, Odświerz, Zaznacz obszar, Wybór elementów ramką zaznaczenia, Zaznacz wszystko, Usuń, Wyślij do konsoli Python, Umiejscowienie, Przemieszczenie, Wyrównanie, Przełącz tryb edycji, Preferencje

Widok:
- Różności: Utwórz widok, Widok ortogonalny, Widok perspektywy, Pełny ekran, Ramka otaczająca, Symbol osi, Płaszczyzna tnąca, Mapowanie tekstury, Przełącz tryb nawigacji, Wygląd zewnętrzny, Kolor losowy, Środowisko pracy, Pasek stanu
- Widok standardowy: Dopasuj wszystko, Widok dopasowany do wyboru, Izometryczny, Dimetryczny, Trimetryczny, Domyślny, Widok od przodu, Widok od góry, Widok z prawej, Widok od tyłu, Widok od góry, Widok z lewej, Odwróć widok w lewo, Odwróć widok w prawo
- Zamroź obraz: Zapisz widok, Wczytaj widok, Zamroź widok, Wyczyść widoki, Odtwórz widok
- Styl kreślenia: Jak jest, Wierzchołki, Szkielet, Ukryte linie, Bez cieniowania, Cieniowany, Płaska linia
- Stereo: Widok stereo czerwony / cyjan, Widok poczwórny bufor stereo, Widok stereo z przeplotem wierszy, Widok stereo z przeplotem kolumn, Wyłącz widok trójwymiarowy, Ustaw ujęcie widoku
- Przybliżenie: Przybliż widok, Oddal widok, Dostosuj widok do ramki otaczjącej
- Okno dokumentu: Zablokuj widok, Odblokuj widok, Wyświetl na pełnym ekranie
- Widoczność: Przełącz widoczność, Pokaż zaznaczenie, Ukryj zaznaczone, Zaznacz widoczne obiekty, Przełącz widoczność, Wyświetl wszystkie obiekty, Ukryj obiekty, Przełącz wybór, Przełącz widoczność wymiarów, Usuń widoczne wymiary
- Paski narzędzi: Plik, Środowisko pracy, Makrodefinicje, Widok, Struktura
- Panele: Widok raportu, Widok drzewa, Edytor właściwości, Widok zaznaczenia, Widok połączony, Konsola Python, Widok DAG
- Akcje widoku drzewa: Wybór w widoku drzewa, Synchronizuj wybór w widoku drzewa, Synchronizuj umiejscowienie w widoku drzewa, Wybór wstępny w widoku drzewa, Zapisz wybór z widoku drzewa, Jeden dokument w widoku drzewa, Wiele dokumentów w widoku drzewa, Zwiń dokument w widoku drzewa, Przeciąganie w widoku drzewa, Wybór w widoku drzewa

Przybory: Edytor parametrów, Zrzut ekranu, Wczytaj grafikę, Inspektor sceny, Graf zależności, Narzędzia projektu, Wymiarowanie odległości, Dokument tekstowy, Widok demonstracyjny, Kalkulator jednostek, Dostosuj, Menadżer dodatków

Makrodefinicje: Rejestruj makropolecenie, Zakończ nagrywania makrodefinicji, Wykonaj makrodefinicję, Ostatnio używane makrodefinicje, Wykonaj makrodefinicję w trakcie edycji, Przełącz na debuger zewnętrzny, Uruchom debugowanie, Zatrzymaj debugowanie, Krok dalej, Wejdź do, Przełącz punkt przerwania

Okna: Następne, Poprzednie, Sąsiadująco, Kaskadowo, Okna

Pomoc: Pomoc online, Witryna FreeCAD, Dokumentacja użytkowników, Dokumentacja skryptów środowiska Python, Pomoc dla środowiska Python, Forum FreeCAD, Często zadawane pytania, Informacje o FreeCAD, Co to jest

Struktura i odnośniki: Std: Część, Std: Grupa, Std: Utwórz łącze, Utwórz odnośnik względny, Zastąp odnośnikiem, Odłącz odnośnik, Importuj odnośnik, Importuj wszystkie odnośniki, Wybierz połączone odnośnikami, Przejdź do najgłębiej połączonego obiektu, Wybierz wszystkie łącza

Dodatkowe: Przywróć wybór, Ponów wybór